home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / getty.z / getty
Encoding:
Text File  |  1998-10-20  |  10.3 KB  |  199 lines
  1.  
  2.  
  3.  
  4. GGGGEEEETTTTTTTTYYYY((((1111MMMM))))                                                            GGGGEEEETTTTTTTTYYYY((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      getty - set terminal type, modes, speed, and line discipline
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////ssssbbbbiiiinnnn////ggggeeeettttttttyyyy [----hhhhNNNN] [----tttt timeout] line [speed [type [linedisc]]]
  13.      ////ssssbbbbiiiinnnn////ggggeeeettttttttyyyy ----cccc file
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _g_e_t_t_y is a program that is invoked by _i_n_i_t(1M).  It is the second process
  17.      in the series, (_i_n_i_t-_g_e_t_t_y-_l_o_g_i_n-_s_h_e_l_l) that ultimately connects a user
  18.      with the UNIX system.  It can only be executed by the super-user; that
  19.      is, a process with the user-ID of rrrrooooooootttt.  Initially _g_e_t_t_y prints the
  20.      contents of ////eeeettttcccc////iiiissssssssuuuueeee (if it exists), then prints the login message
  21.      field for the entry it is using from ////eeeettttcccc////ggggeeeettttttttyyyyddddeeeeffffssss, reads the user's
  22.      login name, and invokes the _l_o_g_i_n(1) command with the user's name as
  23.      argument.  While reading the name, _g_e_t_t_y attempts to adapt the system to
  24.      the speed and type of terminal being used.  It does this by using the
  25.      options and arguments specified.
  26.  
  27.      _L_i_n_e is the name of a tty line in ////ddddeeeevvvv to which _g_e_t_t_y is to attach
  28.      itself.  _g_e_t_t_y uses this string as the name of a file in the ////ddddeeeevvvv
  29.      directory to open for reading and writing.  Unless _g_e_t_t_y is invoked with
  30.      the ----hhhh flag, _g_e_t_t_y will force a hangup on the line by setting the speed
  31.      to zero before setting the speed to the default or specified speed.  The
  32.      ----tttt flag plus _t_i_m_e_o_u_t (in seconds), specifies that _g_e_t_t_y should exit if
  33.      the open on the line succeeds and no one types anything in the specified
  34.      number of seconds.
  35.  
  36.      The ----NNNN option honors the ////eeeettttcccc////nnnnoooollllooooggggiiiinnnn file.  When present, _g_e_t_t_y does not
  37.      answer the line, but instead waits for the file to go away.
  38.  
  39.      _S_p_e_e_d, the optional second argument, is a label to a speed and tty
  40.      definition in the file ////eeeettttcccc////ggggeeeettttttttyyyyddddeeeeffffssss.  This definition tells _g_e_t_t_y at
  41.      what speed to initially run, what the login message should look like,
  42.      what the initial tty settings are, and what speed to try next should the
  43.      user indicate that the speed is inappropriate (by typing a <_b_r_e_a_k>
  44.      character).
  45.  
  46.      _T_y_p_e, the optional third argument, is a character string describing to
  47.      _g_e_t_t_y what type of terminal is connected to the line in question.  _g_e_t_t_y
  48.      recognizes the following types:
  49.  
  50.           nnnnoooonnnneeee           default
  51.           ddddssss44440000----1111         Dataspeed40/1
  52.           tttteeeekkkkttttrrrroooonnnniiiixxxx,,,,tttteeeekkkk  Tektronix
  53.           vvvvtttt66661111           DEC vt61
  54.           vvvvtttt111100000000          DEC vt100
  55.           hhhhpppp44445555           Hewlett-Packard 45
  56.           cccc111100000000           Concept 100
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. GGGGEEEETTTTTTTTYYYY((((1111MMMM))))                                                            GGGGEEEETTTTTTTTYYYY((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      The default terminal is nnnnoooonnnneeee; i.e., any crt or normal terminal unknown to
  75.      the system.  Also, for terminal type to have any meaning, the virtual
  76.      terminal handlers must be compiled into the operating system.  They are
  77.      available, but not compiled in the default condition.
  78.  
  79.      _L_i_n_e_d_i_s_c, the optional fourth argument, is a character string describing
  80.      which line discipline to use in communicating with the terminal.  There
  81.      are two line disciplines.  LLLLDDDDIIIISSSSCCCC0000 is the familiar System V line
  82.      discipline.  LLLLDDDDIIIISSSSCCCC1111 is similar to the 4.3BSD ``new _t_t_y driver'' (see
  83.      _t_e_r_m_i_o(7)).  LLLLDDDDIIIISSSSCCCC1111 is the default.
  84.  
  85.      When given no optional arguments, _g_e_t_t_y sets the _s_p_e_e_d of the interface
  86.      to 9600 baud, specifies that raw mode is to be used (awaken on every
  87.      character), that echo is to be suppressed, either parity allowed, new-
  88.      line characters will be converted to carriage return-line feed, and tab
  89.      expansion performed on the standard output.  It types the login message
  90.      before reading the user's name a character at a time.  If a null
  91.      character (or framing error) is received, it is assumed to be the result
  92.      of the user pushing the ``break'' key.  This will cause _g_e_t_t_y to attempt
  93.      the next _s_p_e_e_d in the series.  The series that _g_e_t_t_y tries is determined
  94.      by what it finds in ////eeeettttcccc////ggggeeeettttttttyyyyddddeeeeffffssss.  Modems which "lock" to a single
  95.      speed, such as most high speed modems, should be used with a ggggeeeettttttttyyyyddddeeeeffffssss
  96.      entry which sticks to a single speed, such as dx_19200.  This also
  97.      applies to devices that send spurious ``break'' signals.  To allow baud
  98.      rate cycling on the main serial console, change the ttyd1 entry from
  99.      console to co_9600.
  100.  
  101.      After the user's name has been typed in, it is terminated by a new-line
  102.      or carriage-return character.  The latter results in the system being set
  103.      to treat carriage returns appropriately (see _i_o_c_t_l(2)).
  104.  
  105.      The user's name is scanned to see if it contains any lower-case
  106.      alphabetic characters; if not, and if the name is non-empty, the system
  107.      is told to map any future upper-case characters into the corresponding
  108.      lower-case characters.
  109.  
  110.      Finally, _l_o_g_i_n is eeeexxxxeeeecccc(2)'d with the user's name as an argument.
  111.      Additional arguments may be typed after the login name.  These are passed
  112.      to _l_o_g_i_n, which will place them in the environment (see _l_o_g_i_n(1)).
  113.  
  114.      If _g_e_t_t_y is running on the graphics console, _g_e_t_t_y checks to see if
  115.      autologin is enabled by verifying the existence of ////eeeettttcccc////aaaauuuuttttoooollllooooggggiiiinnnn and
  116.      ////eeeettttcccc////aaaauuuuttttoooollllooooggggiiiinnnn....oooonnnn (see _l_o_g_i_n(1)).  If autologin is enabled, _g_e_t_t_y will
  117.      invoke _l_o_g_i_n with the autologin option.
  118.  
  119.      _g_e_t_t_y cannot be used on a line that is also to be used by outgoing calls
  120.      made by _u_u_c_p, _c_u, or similar programs.  The very similar _u_u_g_e_t_t_y(1M) use
  121.      should be used instead.
  122.  
  123.      When _g_e_t_t_y is invoked with the ----cccc option and _f_i_l_e, it scans the file as
  124.      if it were scanning ////eeeettttcccc////ggggeeeettttttttyyyyddddeeeeffffssss during normal operation, and prints
  125.      out the results to the standard output.  If there are any unrecognized
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. GGGGEEEETTTTTTTTYYYY((((1111MMMM))))                                                            GGGGEEEETTTTTTTTYYYY((((1111MMMM))))
  137.  
  138.  
  139.  
  140.      modes or improperly constructed entries, it reports these.  If the
  141.      entries are correct, it prints out the values of the various flags.  See
  142.      _i_o_c_t_l(2) to interpret the values.  Note that some values are added to the
  143.      flags automatically.
  144.  
  145. FFFFIIIILLLLEEEESSSS
  146.      /etc/nologin
  147.      /etc/gettydefs
  148.      /etc/issue     message printed before _l_o_g_i_n prompt
  149.      /etc/autologin
  150.      /etc/autologin.on
  151.      /var/adm/SYSLOG
  152.  
  153. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  154.      init(1M), login(1), uugetty(1M), cu(1C), uucp(1C), ioctl(2),
  155.      gettydefs(4), inittab(4), tty(7), serial(7)
  156.  
  157. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  158.      Most error messages are sent to the system log, /_v_a_r/_a_d_m/_S_Y_S_L_O_G.  A
  159.      message similar to
  160.  
  161.           _gggg_eeee_tttt_tttt_yyyy_[[[[_5555_3333_1111_0000_]]]]_:::: _iiii_oooo_cccc_tttt_llll_((((_TTTT_CCCC_SSSS_EEEE_TTTT_AAAA_FFFF_))))_5555_8888_4444_:::: _IIII_nnnn_vvvv_aaaa_llll_iiii_dddd _aaaa_rrrr_gggg_uuuu_mmmm_eeee_nnnn_tttt
  162.  
  163.      may indicate that the tty line does not support the baud rate specified
  164.      in /_e_t_c/_g_e_t_t_y_d_e_f_s.  See _s_e_r_i_a_l(_7) for information on which baud rates are
  165.      supported.
  166.  
  167. BBBBUUUUGGGGSSSS
  168.      While _g_e_t_t_y understands simple single character quoting conventions, it
  169.      is not possible to quote certain special control characters used by
  170.      _g_e_t_t_y.  Thus, you cannot login via _g_e_t_t_y and type a ####, @@@@, ////, !!!!, ____,
  171.      backspace, ^^^^UUUU, ^^^^DDDD, or &&&& as part of your login name or arguments.  _g_e_t_t_y
  172.      uses them to determine when the end of the line has been reached, which
  173.      protocol is being used, and what the erase character is.  They will
  174.      always be interpreted as having their special meaning.
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.